home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL / glubeginpolygon.z / glubeginpolygon
Encoding:
Text File  |  2002-10-03  |  5.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. gggglllluuuuBBBBeeeeggggiiiinnnnPPPPoooollllyyyyggggoooonnnn((((3333GGGG))))            OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee            gggglllluuuuBBBBeeeeggggiiiinnnnPPPPoooollllyyyyggggoooonnnn((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      gggglllluuuuBBBBeeeeggggiiiinnnnPPPPoooollllyyyyggggoooonnnn,,,, gggglllluuuuEEEEnnnnddddPPPPoooollllyyyyggggoooonnnn - delimit a polygon description
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void gggglllluuuuBBBBeeeeggggiiiinnnnPPPPoooollllyyyyggggoooonnnn( GLUtesselator* _t_e_s_s )
  14.  
  15.      void gggglllluuuuEEEEnnnnddddPPPPoooollllyyyyggggoooonnnn( GLUtesselator* _t_e_s_s )
  16.  
  17.  
  18. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  19.      _t_e_s_s  Specifies the tessellation object (created with gggglllluuuuNNNNeeeewwwwTTTTeeeessssssss).
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      gggglllluuuuBBBBeeeeggggiiiinnnnPPPPoooollllyyyyggggoooonnnn and gggglllluuuuEEEEnnnnddddPPPPoooollllyyyyggggoooonnnn delimit the definition of a nonconvex
  23.      polygon.  To define such a polygon, first call gggglllluuuuBBBBeeeeggggiiiinnnnPPPPoooollllyyyyggggoooonnnn.  Then
  24.      define the contours of the polygon by calling gggglllluuuuTTTTeeeessssssssVVVVeeeerrrrtttteeeexxxx for each
  25.      vertex and gggglllluuuuNNNNeeeexxxxttttCCCCoooonnnnttttoooouuuurrrr to start each new contour.  Finally, call
  26.      gggglllluuuuEEEEnnnnddddPPPPoooollllyyyyggggoooonnnn to signal the end of the definition.  See the gggglllluuuuTTTTeeeessssssssVVVVeeeerrrrtttteeeexxxx
  27.      and gggglllluuuuNNNNeeeexxxxttttCCCCoooonnnnttttoooouuuurrrr reference pages for more details.
  28.  
  29.      Once gggglllluuuuEEEEnnnnddddPPPPoooollllyyyyggggoooonnnn is called, the polygon is tessellated, and the
  30.      resulting triangles are described through callbacks.  See gggglllluuuuTTTTeeeessssssssCCCCaaaallllllllbbbbaaaacccckkkk
  31.      for descriptions of the callback functions.
  32.  
  33. NNNNOOOOTTTTEEEESSSS
  34.      This command is obsolete and is provided for backward compatibility only.
  35.      Calls to gggglllluuuuBBBBeeeeggggiiiinnnnPPPPoooollllyyyyggggoooonnnn are mapped to gggglllluuuuTTTTeeeessssssssBBBBeeeeggggiiiinnnnPPPPoooollllyyyyggggoooonnnn followed by
  36.      gggglllluuuuTTTTeeeessssssssBBBBeeeeggggiiiinnnnCCCCoooonnnnttttoooouuuurrrr. Calls to gggglllluuuuEEEEnnnnddddPPPPoooollllyyyyggggoooonnnn are mapped to
  37.      gggglllluuuuTTTTeeeessssssssEEEEnnnnddddCCCCoooonnnnttttoooouuuurrrr followed by gggglllluuuuTTTTeeeessssssssEEEEnnnnddddPPPPoooollllyyyyggggoooonnnn.
  38.  
  39. EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  40.      A quadrilateral with a triangular hole in it can be described like this:
  41.  
  42.  
  43.           gluBeginPolygon(tobj);
  44.              gluTessVertex(tobj, v1, v1);
  45.              gluTessVertex(tobj, v2, v2);
  46.              gluTessVertex(tobj, v3, v3);
  47.              gluTessVertex(tobj, v4, v4);
  48.           gluNextContour(tobj, GLU_INTERIOR);
  49.              gluTessVertex(tobj, v5, v5);
  50.              gluTessVertex(tobj, v6, v6);
  51.              gluTessVertex(tobj, v7, v7);
  52.           gluEndPolygon(tobj);
  53.  
  54.  
  55. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  56.      gggglllluuuuNNNNeeeewwwwTTTTeeeessssssss, gggglllluuuuNNNNeeeexxxxttttCCCCoooonnnnttttoooouuuurrrr, gggglllluuuuTTTTeeeessssssssCCCCaaaallllllllbbbbaaaacccckkkk, gggglllluuuuTTTTeeeessssssssVVVVeeeerrrrtttteeeexxxx,
  57.      gggglllluuuuTTTTeeeessssssssBBBBeeeeggggiiiinnnnPPPPoooollllyyyyggggoooonnnn, gggglllluuuuTTTTeeeessssssssBBBBeeeeggggiiiinnnnCCCCoooonnnnttttoooouuuurrrr
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. gggglllluuuuBBBBeeeeggggiiiinnnnPPPPoooollllyyyyggggoooonnnn((((3333GGGG))))            OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee            gggglllluuuuBBBBeeeeggggiiiinnnnPPPPoooollllyyyyggggoooonnnn((((3333GGGG))))
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.                                                                         PPPPaaaaggggeeee 2222
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.